home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / string / RCS / mem.man,v < prev    next >
Encoding:
Text File  |  1989-02-09  |  2.7 KB  |  112 lines
  1. head     1.2;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.2
  10. date     89.02.09.10.27.17;  author ouster;  state Exp;
  11. branches ;
  12. next     1.1;
  13.  
  14. 1.1
  15. date     89.01.09.10.22.16;  author ouster;  state Exp;
  16. branches ;
  17. next     ;
  18.  
  19.  
  20. desc
  21. @@
  22.  
  23.  
  24. 1.2
  25. log
  26. @Changed OPTIONS => ARGUMENTS.
  27. @
  28. text
  29. @' Copyright 1989 Regents of the University of California
  30. ' Permission to use, copy, modify, and distribute this
  31. ' documentation for any purpose and without fee is hereby
  32. ' granted, provided that this notice appears in all copies.
  33. ' The University of California makes no representations about
  34. ' the suitability of this material for any purpose.  It is
  35. ' provided "as is" without express or implied warranty.
  36. ' 
  37. ' $Header: /sprite/src/lib/c/string/RCS/mem.man,v 1.1 89/01/09 10:22:16 ouster Exp Locker: ouster $ SPRITE (Berkeley)
  38. ' 
  39. .so \*(]ltmac.sprite
  40. .HS mem lib
  41. .BS
  42. .SH NAME
  43. memchr, memcmp, memcpy, memset \- Operations on byte arrays
  44. .SH SYNOPSIS
  45. .nf
  46. \fB#include <string.h>
  47.  
  48. \fBchar *
  49. \fBmemchr(\fIs\fB, \fIc\fB, \fIn\fB)
  50.  
  51. \fBint
  52. \fBmemcmp(\fIs\fB, \fIs2\fB, \fIn\fB)
  53.  
  54. \fBchar *
  55. \fBmemcpy(\fIdest\fB, \fIsource\fB, \fIn\fB)
  56.  
  57. \fBchar *
  58. \fBmemset(\fIdest\fB, \fIc\fB, \fIn\fB)
  59. .SH ARGUMENTS
  60. .AS char source
  61. .AP char *s in
  62. Pointer to array of characters.
  63. .AP char *source in
  64. Pointer to array of characters to copy.
  65. .AP char *dest out
  66. Pointer to array of characters to modify.
  67. .AP int c in
  68. Value to search for (\fBmemchr\fR), or value to set to (\fBmemset\fR).
  69. .AP int n in
  70. Count of number of characters to test, copy, or set.
  71. .BE
  72.  
  73. .SH DESCRIPTION
  74. These procedures manipulate memory as counted arrays of bytes.
  75. .PP
  76. The \fBmemchr\fR procedure searches for the first occurrence of \fIc\fR
  77. in the \fIn\fR bytes starting at \fIs\fR, and returns the address of the
  78. first such occurrence.  If the value \fIc\fR is not found, then \fBNULL\fR
  79. is returned.
  80. .PP
  81. \fBMemcmp\fR compares two arrays of bytes, \fIs\fR and \fIs2\fR, in
  82. order, until a difference is found or \fIn\fR bytes have been compared.
  83. It returns a value greater than zero if, in the first differing byte,
  84. the value \fIs\fR is greater than the value in \fIs2\fR.  If the value
  85. in \fIs\fR is less than the value in \fIs2\fR, then a value less than
  86. zero is returned.  If the two arrays are identical in their first \fIn\fR
  87. bytes, then zero is returned.  Signed character comparison is used.
  88. .PP
  89. \fBMemcpy\fR copies \fIn\fR bytes from \fIsource\fR to \fIdest\fR and
  90. returns \fIdest\fR as its result.
  91. .PP
  92. \fBMemset\fR stores the value \fIc\fR in each of the \fIn\fR bytes starting
  93. at \fIdest\fR, and returns \fIdest\fR as its result.
  94.  
  95. .SH KEYWORDS
  96. characters, copy, memory, set, test
  97. @
  98.  
  99.  
  100. 1.1
  101. log
  102. @Initial revision
  103. @
  104. text
  105. @d9 1
  106. a9 1
  107. ' $Header: /sprite/lib/forms/RCS/proto.man,v 1.2 89/01/05 17:31:38 ouster Exp $ SPRITE (Berkeley)
  108. d31 1
  109. a31 1
  110. .SH OPTIONS
  111. @
  112.